home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / pidentd / identd.LOCAL next >
Text File  |  1995-07-30  |  10KB  |  155 lines
  1.  
  2.      IIIIDDDDEEEENNNNTTTTDDDD((((8888))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((22227777 MMMMaaaayyyy 1111999999992222))))          IIIIDDDDEEEENNNNTTTTDDDD((((8888))))
  3.  
  4.      NNNNAAAAMMMMEEEE
  5.           identd, in.identd - TCP/IP IDENT protocol server
  6.  
  7.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  8.           ////uuuussssrrrr////ssssbbbbiiiinnnn////iiiinnnn....iiiiddddeeeennnnttttdddd [----iiii|----wwww|----bbbb [----tttt<<<<sssseeeeccccoooonnnnddddssss>>>>] [----uuuu<<<<uuuuiiiidddd>>>>]
  9.           [----gggg<<<<ggggiiiidddd>>>>] [----pppp<<<<ppppoooorrrrtttt>>>>] [----aaaa<<<<aaaaddddddddrrrreeeessssssss>>>>] [----cccc<<<<cccchhhhaaaarrrrsssseeeetttt>>>>] [----nnnn] [----oooo]
  10.           [----eeee] [----llll] [----VVVV] [----mmmm] [----NNNN] [----dddd] [kkkkeeeerrrrnnnneeeellllffffiiiilllleeee[kkkkmmmmeeeemmmmffffiiiilllleeee]]]]]
  11.  
  12.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  13.           iiiiddddeeeennnnttttdddd is a server which implements the TCP/IP proposed
  14.           standard IDENT user identification protocol as specified in
  15.           the RFC 1413 document.
  16.  
  17.           iiiiddddeeeennnnttttdddd operates by looking up specific TCP/IP connections
  18.           and returning the user name of the process owning the
  19.           connection.
  20.  
  21.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  22.           The ----iiii flag, which is the default mode, should be used when
  23.           starting the daemon from iiiinnnneeeettttdddd with the "nowait" option in
  24.           the ////eeeettttcccc////iiiinnnneeeettttdddd....ccccoooonnnnffff file. Use of this mode will make iiiinnnneeeettttdddd
  25.           start one iiiiddddeeeennnnttttdddd daemon for each connection request.
  26.  
  27.           The ----wwww flag should be used when starting the daemon from
  28.           iiiinnnneeeettttdddd with the "wait" option in the ////eeeettttcccc////iiiinnnneeeettttdddd....ccccoooonnnnffff file .
  29.           This is the prefered mode of operation since that will start
  30.           a copy of iiiiddddeeeennnnttttdddd at the first connection request and then
  31.           iiiiddddeeeennnnttttdddd will handle subsequent requests without having to do
  32.           the nlist lookup in the kernel file for every request as in
  33.           the ----iiii mode above. The iiiiddddeeeennnnttttdddd daemon will run either
  34.           forever, until a bug makes it crash or a timeout, as
  35.           specified by the ----tttt flag, occurs.
  36.  
  37.           The ----bbbb flag can be used to make the daemon run in standalone
  38.           mode without the assistance from iiiinnnneeeettttdddd.... This mode is the
  39.           least prefered mode since a bug or any other fatal condition
  40.           in the server will make it terminate and it will then have
  41.           to be restarted manually. Other than that is has the same
  42.           advantage as the ----wwww mode in that it parses the nlist only
  43.           once.
  44.  
  45.           The ----tttt<<<<sssseeeeccccoooonnnnddddssss>>>> option is used to specify the timeout limit.
  46.           This is the number of seconds a server started with the ----wwww
  47.           flag will wait for new connections before terminating. The
  48.           server is automatically restarted by iiiinnnneeeettttdddd whenever a new
  49.           connection is requested if it has terminated. A suitable
  50.           value for this is 120 (2 minutes), if used. It defaults to
  51.           no timeout (ie, will wait forever, or until a fatal
  52.           condition occurs in the server).
  53.  
  54.           The ----uuuu<<<<uuuuiiiidddd>>>> option is used to specify a user id number which
  55.           the iiiiddddeeeennnntttt server should switch to after binding itself to
  56.           the TCP/IP port if using the ----bbbb mode of operation.
  57.  
  58.           The ----gggg<<<<ggggiiiidddd>>>> option is used to specify a group id number
  59.           which the iiiiddddeeeennnntttt server should switch to after binding itself
  60.           to the TCP/IP port if using the ----bbbb mode of operation.
  61.  
  62.           The ----pppp<<<<ppppoooorrrrtttt>>>> option is used to specify an alternative port
  63.           number to bind to if using the ----bbbb mode of operation. It can
  64.           be specified by name or by number. Defaults to the IDENT
  65.           port (113).
  66.  
  67.           The ----aaaa<<<<aaaaddddddddrrrreeeessssssss>>>> option is used to specify the local address
  68.           to bind the socket to if using the ----bbbb mode of operation. Can
  69.           only be specified by IP address and not by domain name.
  70.           Defaults to the INADDR_ANY address which normally means all
  71.           local addresses.
  72.  
  73.           The ----VVVV flag makes iiiiddddeeeennnnttttdddd display the version number and the
  74.           exit.
  75.  
  76.           The ----llll flag tells iiiiddddeeeennnnttttdddd to use the System logging daemon
  77.           ssssyyyyssssllllooooggggdddd for logging purposes.
  78.  
  79.           The ----oooo flag tells iiiiddddeeeennnnttttdddd to not reveal the operating system
  80.           type it is run on and to instead always return "OTHER".
  81.  
  82.           The ----eeee flag tells iiiiddddeeeennnnttttdddd to always return "UNKNOWN-ERROR"
  83.           instead of the "NO-USER" or "INVALID-PORT" errors.
  84.  
  85.           The ----cccc<<<<cccchhhhaaaarrrrsssseeeetttt>>>> flags tells iiiiddddeeeennnnttttdddd to add the optional
  86.           (according to the IDENT protocol) character set designator
  87.           to the reply generated. <charset> should be a valid
  88.           character set as described in the MIME RFC in upper case
  89.           characters.
  90.  
  91.           The ----nnnn flags tells iiiiddddeeeennnnttttdddd to always return user numbers
  92.           instead of user names if you wish to keep the user names a
  93.           secret.
  94.  
  95.           The ----NNNN flag makes iiiiddddeeeennnnttttdddd check for a file ".noident" in each
  96.           homedirectory for a user which the daemon is about to return
  97.           the user name for. It that file exists then the daemon will
  98.           give the error HHHHIIIIDDDDDDDDEEEENNNN----UUUUSSSSEEEERRRR instead of the normal USERID
  99.           response.
  100.  
  101.           ----mmmm flag makes iiiiddddeeeennnnttttdddd use a mode of operation that will allow
  102.           multiple requests to be processed per session. Each request
  103.           is specified one per line and the responses will be returned
  104.           one per line. The connection will not be closed until the
  105.           connecting part closes it's end of the line.  PLEASE NOTE
  106.           THAT THIS MODE VIOLATES THE PROTOCOL SPECIFICATION AS IT
  107.           CURRENTLY STANDS.
  108.  
  109.           The ----dddd flag enables some debugging code that normally should
  110.           NOT be enabled since that breaks the protocol and may reveal
  111.           information that should not be available to outsiders.
  112.  
  113.           kkkkeeeerrrrnnnneeeellllffffiiiilllleeee defaults to the normally running kernel file.
  114.  
  115.           kkkkmmmmeeeemmmmffffiiiilllleeee defaults to the memory space of the normally
  116.           running kernel.
  117.  
  118.      IIIINNNNSSSSTTTTAAAALLLLLLLLAAAATTTTIIIIOOOONNNN
  119.           iiiiddddeeeennnnttttdddd is invoked either by the internet server (see
  120.           iiiinnnneeeettttdddd(8C) ) for requests to connect to the IDENT port as
  121.           indicated by the ////eeeettttcccc////sssseeeerrrrvvvviiiicccceeeessss file (see sssseeeerrrrvvvviiiicccceeeessss(5) ) when
  122.           using the ----wwww or ----iiii modes of operation or started manually by
  123.           using the ----bbbb mode of operation.
  124.  
  125.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  126.           Assuming the server is located in ////uuuussssrrrr////eeeettttcccc////iiiinnnn....iiiiddddeeeennnnttttdddd one can
  127.           put either:
  128.  
  129.           ident stream tcp wait sys /usr/etc/in.identd in.identd -w
  130.           -t120
  131.  
  132.           or:
  133.  
  134.           ident stream tcp nowait sys /usr/etc/in.identd in.identd -i
  135.  
  136.           into the ////eeeettttcccc////iiiinnnneeeettttdddd....ccccoooonnnnffff file. User "sys" should have enough
  137.           rights to READ the kernel but NOT to write to it.
  138.  
  139.           To start it using the ----bbbb mode of operation one can put a
  140.           line like this into the ////eeeettttcccc////rrrrcccc....llllooooccccaaaallll file:
  141.  
  142.           /usr/etc/in.identd -b -u2 -g2
  143.  
  144.           This will make it run in the background as user 2, group 2
  145.           (user "sys", group "kmem" on SunOS 4.1.1).
  146.  
  147.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  148.           aaaauuuutttthhhhuuuusssseeeerrrr(3) iiiinnnneeeettttdddd....ccccoooonnnnffff(5)
  149.  
  150.      BBBBUUUUGGGGSSSS
  151.           The handling of fatal errors could be better.
  152.  
  153.                                                      (printed 7/30/95)
  154.  
  155.